home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / DJGPP / CBGRD103.ZIP / contrib / libgrx / 103_read.me next >
Text File  |  1993-12-06  |  6KB  |  151 lines
  1. RELEASE NOTES FOR GRX VERSION 1.03
  2. ==================================
  3.  
  4.  
  5. 1. What is it?
  6. --------------
  7.  
  8.  
  9. GRX 1.03 is a temporary version soon to be replaced with version
  10. 1.04. It is released now mostly to support some of the new features
  11. of DJGPP 1.11. This version is still based on the virtual, page fault
  12. based VGA memory mapping provided by GO32 in its non-DPMI modes. GRX
  13. 1.04 which is currently under testing will have completely rewritten
  14. internal VGA frame buffer access routines which do not rely on the
  15. above GO32 feature any more. For this reason GRX 1.04 will work under
  16. DPMI (i.e. full screen DOS sessions under Windows or OS/2) while this
  17. version does not. Furthermore GRX 1.04 will support full screen
  18. resolutions even when it is compiled with Turbo (or Borland) C. Finally,
  19. 1.04 will also support full screen graphics under Linux.
  20.  
  21. I have decided not to provide additional video memory models (number of
  22. colors) for 1.03, only those models which were present in 1.02 are supported.
  23. This includes 16, 256, and 32768 color SVGA modes and 256 color accelerated
  24. S3 and 8514/A modes. The new frame buffer codes for mono, 16 and 24 bitplane
  25. modes have been written such that they work with the new banking method --
  26. which means that they cannot be included in this version.
  27.  
  28.  
  29. 2. What's new?
  30. --------------
  31.  
  32.  
  33. Although GRX 1.03 basically provides the same functionality as 1.02 there
  34. are a couple of improvements over that version:
  35.  
  36.     -    The full set of wide and/or patterned line primitives is now supported.
  37.  
  38.     -    VESA support.
  39.  
  40.     -    GRX 1.03 when used together with GO32 1.11+ will support video modes
  41.     which use more than 1MB of video RAM.
  42.  
  43.     -    Faster horizontal scan line and area fills on many SVGA cards. Known
  44.     to work on Tseng ET4000 and Cirrus 5426+ cards, known not to work
  45.     on S3-s when accessed VGA-style. Otherwise, see "grdriver.h" and
  46.     experiment with the "GRD_8_F_PLANES" flag. (See also "et4000.asm" or
  47.     "cl5426.asm")
  48.  
  49.     -    Numerous bug fixes.
  50.  
  51.     -    Included contributed drivers from
  52.     'omnigate.clarkson.edu:/pub/msdos/djgpp/pub'
  53.     NOTE: I cannot test these drivers, in case of trouble contact their authors.
  54.  
  55.     -    Added changes necessary to link the BCC2GRX library. This version of GRX
  56.     supersedes the version distributed with BCC2GRX.
  57.  
  58.  
  59. There is a new driver format (.VDR) which extends the old .GRD and .GRN drivers
  60. in several ways:
  61.  
  62.     -    Supports "weird" SVGA cards with bank sizes other than 64K
  63.  
  64.     -    Supports SVGA cards with "irregular" pixel formats in HiColor
  65.     (32K, 64K, 16M) color modes.
  66.  
  67.     -    Allows "virtual" video modes, where the frame buffer is larger than
  68.     the displayed resolution. In these modes the drivers also support
  69.     panning. NOTE: this feature of the .VDR drivers is not supported in
  70.     1.03, but it will be fully supported in 1.04.
  71.  
  72. GO32 1.11+ has a new VESA compatible built-in .VDR format driver -- for most
  73. VESA compatible cards you will not need to load an external driver.
  74.  
  75.  
  76. 3. New GO32 environment variable format for .VDR drivers:
  77. ---------------------------------------------------------
  78.  
  79.  
  80. The ".VDR" graphics driver format allows the customization
  81. of drivers from options specified in the GO32 environment
  82. variable. These options immediately follow the driver name,
  83. they are preceeded by two colons. If no driver name is
  84. specified (or the given driver does not exist) then the
  85. options are passed to GO32's built-in driver.
  86.  
  87. I.e.
  88.  
  89. set go32=driver viper.vdr::p tw 80 th ....
  90.  
  91.    - use driver: viper.vdr, pass option "p" to it.
  92.  
  93. set go32=driver ::p5f ....
  94.  
  95.    - use the built-in driver, pass options "p5f" to it.
  96.  
  97. The option string can contain any combination of the following
  98. characters (case insensitive):
  99.  
  100.    P: use the driver's paging function in protected mode.
  101.       NOTE: the paging func of .GRD and .GRN drivers is
  102.       always used in protected mode, the default for .VDR
  103.       drivers is real mode.
  104.  
  105.    F: parameters reported by the driver after mode set will
  106.       enable GRX 1.03+'s fast 256 color scan line fill option.
  107.       Does not work on every SVGA chip.
  108.  
  109.    5: Only necessary for VESA driver(s) when the VESA BIOS
  110.       is of version 1.1 or earlier. This option tells the
  111.       driver that the VESA reported 64K color modes actually
  112.       have only 32K colors. Not needed when the VESA BIOS
  113.       version is 1.2 or greater, as these versions report
  114.       the pixel format properly.
  115.  
  116.  
  117. 4. Documentation
  118. ----------------
  119.  
  120. The documentation is being completely rewritten for 1.04. For 1.03 I am
  121. distributing the documentation from 1.02. This is mostly correct, but there
  122. may be a few places where bug fixes and/or improvements made the documentation
  123. inconsistent with the code.
  124.  
  125.  
  126. 5. Copyright stuff
  127. ------------------
  128.  
  129. From 1.03 on I am dropping all royalty requirements on GRX. It is now
  130. distributed under the terms of the GNU LIBRARY GENERAL PUBLIC LICENSE
  131. (LGPL) with one exception:
  132.  
  133.     -    Using the DOS versions (DOS only! this exception DOES NOT apply to
  134.     the Linux version) you are permitted to distribute an application
  135.     linked with GRX in binaries only, provided that the documentation
  136.     of the program:
  137.  
  138.        a)    informs the user that GRX is used in the program, and
  139.  
  140.        b)    provides the user with the necessary information about
  141.         how to obtain GRX. (i.e. ftp site, etc..)
  142.  
  143. As some of the code still may contain copyright information from the previous
  144. versions, in the case of conflict, THIS NOTICE SHOULD BE GIVEN PREFERENCE!!!
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.